SetConditionalFormatting(CellRange[],Boolean,IConditionalFormattingRule[]) Method

Sets conditional formatting for a specified ranges of cells on the sheet based on specified rules.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub SetConditionalFormatting( _
   ByVal cellRanges() As CellRange, _
   ByVal isCombinable As Boolean, _
   ByVal ParamArray rules() As IConditionalFormattingRule _
)

'Usage
 
Dim instance As SheetView
Dim cellRanges() As CellRange
Dim isCombinable As Boolean
Dim rules() As IConditionalFormattingRule
 
instance.SetConditionalFormatting(cellRanges, isCombinable, rules)

public void SetConditionalFormatting( 
   CellRange[] cellRanges,
   bool isCombinable,
   params IConditionalFormattingRule[] rules
)

Parameters

cellRanges: Cell ranges
isCombinable: Indicates that rule(s) can be merged into an existing conditional formatting if they affect the same cell range(s).
rules: Rules to apply for the specified range of cells

Example

This example creates a conditional rule.

private void Form1_Load(object sender, EventArgs e)
        {
            fpSpread1.Sheets[0].Cells[0, 0].Value = 3;
            fpSpread1.Sheets[0].Cells[1, 0].Value = 2;
            fpSpread1.Sheets[0].Cells[1, 1].Value = 10;
            fpSpread1.Sheets[0].Cells[0, 2].Value = 1;            
        }

        private void button1_Click(object sender, EventArgs e)
        {
            FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule unary = new FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, false);
            unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo;
            unary.Value = 10;
            unary.BackColor = Color.Red;
            unary.FontStyle = new FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold);            
     
            FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(true, 10, false, 20, false);
            between.FirstValue = 1;
            between.SecondValue = 20;
            between.IsNotBetween = true;
            between.BackColor = Color.Bisque;
                        
            //SetConditionalFormatting Overload
            fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, false, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, false, unary);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between);
            //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary);
        }

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        FpSpread1.Sheets(0).Cells(0, 0).Value = 3
        FpSpread1.Sheets(0).Cells(1, 0).Value = 2
        FpSpread1.Sheets(0).Cells(1, 1).Value = 10
        FpSpread1.Sheets(0).Cells(0, 2).Value = 1
    End Sub

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
        Dim unary As New FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, False)
        unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo
        unary.Value = 10
        unary.BackColor = Color.Red
        unary.FontStyle = New FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold)

        Dim between As New FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(True, 10, False, 20, False)
        between.FirstValue = 1
        between.SecondValue = 20
        between.IsNotBetween = True
        between.BackColor = Color.Bisque

        'SetConditionalFormatting Overload
        FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, False, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, False, unary)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between)
        'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary)
    End Sub

Requirements

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

Reference

SheetView Class
SheetView Members
Overload List